Java

Installation

For the usage of Orchestra Solution Hub, we require a Java virtual machine with version 21. You can download the file directly from the Amazon website.
You have to choose the package that fits your system. For this guide we use exemplary the 64-version for Linux.

When the download is finished you have to unzip the package by using the following command:

tar -xzf amazon-corretto-21-x64-linux-jdk.tar

Now move the new folder to the target path you want to:

mv amazon-corretto-21.0.2.14.1-linux-x64/ /opt

After that you have to set up the JAVA_HOME and the JRE_HOME in the file /etc/environment by adding:

PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games"
export JAVA_HOME=/opt/amazon-corretto-21.0.2.14.1-linux-x64
export JRE_HOME=/opt/amazon-corretto-21.0.2.14.1-linux-x64/jre

With APT

In order to install the JDK you have to use the following command:

apt-get -y install amazon-corretto-21.0.2.14.1-linux-x64

---

Troubleshooting

Deployment fails due to missing fonts

On headless server systems it might occur that you get an exception like the following while deploying a scenario:

Error: Failed to generate image, caused by NullPointerException in sun.awt.FontConfiguration.getVersion, line 1,264

This means that no font is installed for rendering process models.

In such case make sure to install the fontconfig package:

apt-get -y install fontconfig

---

If you get an exception like:

Assistive Technology not found: org.GNOME.Accessibility.AtkWrapper

You might want to comment out the entry:

assistive_technologies=org.GNOME.Accessibility.AtkWrapper

from:

/etc/amazon-corretto-21.0.2.14.1-linux-x64/accessibility.properties.